home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / graphics / show / show.readme < prev    next >
Text File  |  1999-04-19  |  7KB  |  223 lines
  1. Short:    Cybergfx only picture viewer (040+PPC) V1.17
  2. Author:   al.renard@infoboard.be(Alain Renard)
  3. Uploader: al.renard@infoboard.be(Alain Renard)
  4. Version:  1.17
  5. Type:     gfx/show
  6.  
  7.  
  8. What is it?
  9. ===========
  10. Show is a picture viewer for CyberGraphics systems.
  11. It can decode the next picture formats:
  12. - JPEG,PNG,GIF,TARGA,BMP,PPM,TIFF
  13. and can save in
  14. - JPEG,PNG,TIFF and RAW
  15. It open on a CyberGraphics screen (16/24bits) only.
  16.  
  17.  
  18. Invocation from a shell:
  19. ========================
  20.     Show    FILES,PREFSFILE=PF/K,MODEID=ID/K/N,LOOP=LP/S,NOERROR=NE/S,GETMODEID=GM/S,
  21.             PROGRESS=PG/S,CRYPT=CR/S,PRESERVE=PR/S,OVERWARN=OW/S,CLICK=CL/S,
  22.             LIST=LI/K,JPGQUAL=JQ/K/N,JPGGRAY=JG/S,JPGSIZE=JS/K/N,
  23.             SLIDE=SL/S,SECONDS=SC/K/N,ZOMBIE/S
  24.  
  25. FILES:
  26.     - a mixture of filenames, patterns and directories:
  27.       Example pattern   : RAM:T/#?30#?.tiff
  28.       Example directory : RAM:T/ (equivalent to RAM:T/#?. You have to put the '/'
  29.                                   at the end to indicate a directory!)
  30.  
  31. PREFSFILE=PF/K:
  32.     - alternative prefs file to load at startup (default is ENV:Show.prefs).
  33.  
  34. MODEID=ID/K/N:
  35.     The screen mode (in decimal)
  36.  
  37. LOOP=LP/S:
  38.     If you want endless loop in viewing.
  39.  
  40. NOERROR=NE/S:
  41.     If you do not want the errors being reported.
  42.  
  43. GETMODEID=GM/S:
  44.     Force the mode requester to appear before the program starts.
  45.  
  46. PROGRESS=PG/S:
  47.     Open the progress window when loading a picture.
  48.  
  49. CRYPT=CR/S:
  50.     Save files crypted.
  51.  
  52. PRESERVE=PR/S:
  53.     Preserve files dates.
  54.  
  55. OVERWARN=OW/S:
  56.     Open a requester to ask if you want to overwrite a file.
  57.  
  58. CLICK=CL/S:
  59.     Click with the mouse in the main window loads the next picture.
  60.  
  61. LIST=LI/K:
  62.     Take precedence over the FILES argument.
  63.     When present, Show will read the list file given instead of reading images directly.
  64.     The list file is made of lines of text, each of which is a file name.
  65.  
  66.     Example:
  67.         Show ...(blahblah)... LIST RAM:mylist
  68.  
  69.         and the content of the file RAM:mylist is:
  70.  
  71.         WORK:pics/png/john.png
  72.         WORK:pics/tif/blue_parrot.tif
  73.         DATAS:mypics/eros/Regina.jpg
  74.         ...
  75.  
  76. JPGQUAL=JQ/K/N:
  77.     JPEG save quality (default=80).
  78.  
  79. JPGGRAY=JG/S:
  80.     Load JPEG in grayscale.
  81.  
  82. JPGSIZE=JS/K/N:
  83.     JPEG picture sizing when loading (0=auto, 1=full, 2=1/2, 4=1/4, 8=1/8; default=1).
  84.  
  85. SLIDE=SL/S:
  86.     Mode slideshow.
  87.     Each image is displayed n seconds before the next is loaded.
  88.     You can break this by hitting the ESCAPE key or by a menu item.
  89.     When an image is changed, the slide is paused. To resume it, save the
  90.     image or go to another image.
  91.  
  92. SECONDS=SC/K/N:
  93.     You can decide how much time each image is displayed in slideshow mode.
  94.     Changing the delay is possible (menu item).
  95.  
  96. ZOMBIE/S:
  97.     Special mode; the program stay in memory and do nothing until it receive a command.
  98.     Two commands possible:
  99.     a) QUIT: quit the program ;)
  100.     b) LOAD: load a file and display it.
  101.     The executable ShowZombie is there to send a command to Show.
  102.  
  103. These options take precedence over the preferences saved.
  104. You can also invoque Show simply by
  105.     Show
  106. and a filerequester will appear for you to choose your files.
  107.  
  108. Invocation from Workbench:
  109. ==========================
  110.     The tooltypes are the same than when starting from a shell except there are no
  111.     'LIST' or 'PATTERN'.
  112.     You can use the shortcuts.
  113.  
  114. Usage:
  115. ======
  116. Not much to say, apart for the Compose menu:
  117. Compose allow you to...compose several images in a big one.
  118. To achieve that, you have to 'memorize' the images first.
  119. So say you want to compose image1.jpg, image2.jpg, image3.jpg and image4.jpg:
  120.     - a) load the images (!)
  121.     - b) while each image is displayed, memorize it (menu 'Image/Memory/Memorize Image')
  122.     - c) compose (menu 'Image/Memory/Compose Memorized Images')
  123. Here you can choose the layout and the space between images.
  124. Press 'OK' to save it.
  125. Note: Pressing HELP in the main window help to remember some keyboard shortcuts
  126. while composing or cropping.
  127.  
  128. XPK:
  129. Files compacted/crypted with XPK are OK.
  130. You can even crypt your images from within the program.
  131.  
  132. Preferences:
  133. ============
  134. The preferences are saved in ENVARC:Show.prefs ('Save') and ENV:Show.prefs ('Use').
  135. You can load and save alternatives prefs files.
  136.  
  137. Files comment are always preserved.
  138. You can customize the keyboard as you like.
  139.  
  140. Special keys:
  141. =============
  142.     ESCAPE:     break the slideshow mode.
  143.     SPACE:      go to next image.
  144.     RETURN:     go to next image.
  145.     HELP:       change preferences.
  146.     CURSORS:    move in the image.
  147.  
  148.     F1:         increment (SHIFT=decrement) red by 5.
  149.     F2:         increment (SHIFT=decrement) green by 5.
  150.     F3:         increment (SHIFT=decrement) blue by 5.
  151.     F6:         increment (SHIFT=decrement) brightness by 5.
  152.     F7:         increment (SHIFT=decrement) contrast by 5.
  153.     F8:         increment (SHIFT=decrement) gamma by 5.
  154.  
  155.  
  156. Versions:
  157. =========
  158. There are 2 versions, one for 68040+FPU and the other for 68040+PPC
  159. If you want a 68000 version, please email me!
  160.  
  161. This program is TOTALLY FREE.
  162.  
  163.  
  164. Note:
  165. ======
  166. I'm NOT a programmer, so please forgive me if you find bugs!
  167. Anyway, your comments are always welcome; PLEASE email me
  168. if you have bugs reports, comments, encouragements, etc...
  169.  
  170. History
  171. =======
  172. V1.17
  173. - Alternative prefs files (loading/saving).
  174. - Mixture of filenames, dirs and patterns on command line. This means you can now
  175.   select several files in a Opus lister, for example, and display them in one go.
  176.   (suggestion from D.J. Nick)
  177. - Special keys to increment/decrement colors,brightness,contrast and gamma directly.
  178.   See 'Special keys'.
  179.   (suggestion from Franck Delhomme!)
  180. - PPC version: realtime effects adjustments.
  181. - Windows positions are now saved automatically before quitting.
  182.   (suggestion from Andre Reichl)
  183. - You can now memorise images without they appear in the compose list.
  184.   (suggestion from Andre Reichl)
  185. - New prefs file format. To convert your old prefsfile, use the command old2newprefs
  186.   included!.
  187.  
  188. V1.16
  189. - PPC version.
  190.   The JPG (load/save), PNG (load/save) and the effects are compiled for PPC for now.
  191.   The modules 'ShowEffects.elf', 'ShowPng.elf' and 'ShowJpeg.elf' must reside in the same
  192.   directory as ShowPPC.
  193. - ShowZombie bug fixed. Now you can pass a relative file-path; the path will be passed to
  194.   Show in an absolute form (e.g. 'pics/mypic.jpg' --> 'DH0:data/misc/pics/mypic.jpg').
  195.  
  196. V1.15
  197. - Mode slideshow
  198. - Mode Zombie
  199. - Some bugs fixes
  200.  
  201. V1.14
  202. - Show can now be started from WB.
  203. - Preferences grouped into a window.
  204. - While browsing the memorized pictures in the 'Goto memorized' window, you now see
  205.   the images directly.
  206.  
  207. V1.13
  208. - Added the LIST/K argument in the command line.
  209.  
  210. V1.12
  211. - The grayscale images are now loaded/saved as grayscale in TIFF format
  212. - Added Gamma for PNG loading
  213. - More prefs are saved now
  214.  
  215. V1.11
  216. - Load and save TIFF images.
  217. - Now you can resize the picture freely.
  218. - New menu item: Gamma correction.
  219. - ATTENTION : ixemul.library is now needed!
  220. - ATTENTION : new prefs file format...sorry! :(
  221.  
  222. END.
  223.